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Preface 


Manual Objectives 

This manual provides a step-by-step procedure for installing the VAX 
PASCAL compiler on a VAX/VMS system, and it provides PASCAL pro¬ 
grammers with information that pertains to this release of VAX PASCAL. 


Intended Audience 

This manual is intended for use by system managers and PASCAL pro¬ 
grammers with a working knowledge of VAX/VMS. 


Structure of This Document 

This manual is organized into two chapters. 

Chapter 1 provides information on the following: 

• The procedure for installing the VAX PASCAL compiler 

• The procedure for installing the STARLET library files 

Chapter 2 provides information on the following: 

• Notes on compatibility 

• Command line changes 

• Ways to improve performance 

• Information on known restrictions 











Associated Documents 


• VAX Software Installation Guide 

• VAX/VMS System Management and Operations Guide 

• VAX/VMS Utilities Reference Manual 

• VAX PASCAL User's Guide 

• Programming in VAX PASCAL 


Conventions Used in This Document 


Convention 

Meaning 

[ret] 

A symbol with a one- to six-character 
abbreviation indicates that you press a 
key on the terminal, for example, |RET| . 

ICTRL/xl 

The phrase |CTRL/xl indicates that vou 
must press the key labeled CTRL while 


you simultaneously press another key, 
for example, 1 CTRL/C I , |CTRL/Y| , | CTRL/0 1 . 

$ SHOW TIME 

05-JUN-1985 11:55:22 

Command examples show all output 
lines or prompting characters that the 
system prints or displays in black letters. 
All user-entered commands are shown in 


red letters. 

file-spec,... 

Horizontal ellipses indicate that addi¬ 
tional parameters, values, or information 
can be entered. 
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Chapter 1 

Installation Guide 


This chapter describes the procedure for installing the VAX PASCAL V3.0 
software on the VAX/VMS operating system. The procedure is automated 
and requires only that you (1) mount the kit volumes when prompted, 
and (2) respond to queries issued during the installation procedure. You 
should read this manual and the appropriate VAX Software Installation 
Guide before you begin the installation. 

You should perform the PASCAL installation procedure when there are 
no active PASCAL users on the system. After successful installation, you 
should notify all PASCAL users that a new compiler has been installed. 


1.1 Requirements 

1. System manager privileges 

2. A minimum of 2400 blocks of free disk space (2100 blocks are used 
after installation); the STARLET files require a minimum of 3100 blocks 
of free disk space 

3. Thirty minutes to two hours installation time, depending upon your 
type of media and your system configuration 

4. The VAX/VMS Software Installation Guide pertaining to your system 

5. VAX/VMS V4.0 or later 
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1.2 Contents of Kit 


The VAX PASCAL installation kit consists of two sets of volumes. The 
first set of volumes contains the VAX PASCAL compiler, and the second 
set contains the STARLET.PAS kit. Your cover letter contains the number 
and contents of your media. 


1.3 Installation Procedure 

Begin installation of the VAX PASCAL compiler on any VAX/VMS system 
by performing the following steps: 

1. Log in to the system manager's account. 

2. Invoke VMSINSTAL by using a command of the format: 

$ @SYS$UPDATE:VMSINSTAL {product name} {device} 

The first parameter represents the name of the saveset of the specified 
product to be installed. It consists of the product's facility name, the 
version number, and the update number. 

The second parameter identifies the device where the distribution 
volumes are to be mounted. 

If you do not include this information, VMSINSTAL will prompt 
you for the missing parameters. For further information, refer to the 
appropriate VAX Software Installation Guide. 

NOTE 

For the purpose of this manual, the product name 
PASCAL030 and the device name MTAO: are used as 
examples. For instance, invoke VMSINSTAL by typing: 

$ @SYS$UPDATE:VMSINSTAL PASCAL030 MTAO: 

The product name PASCAL030 indicates VAX PASCAL 
Version 3.0, and the device name MTAO: indicates the 
example's assumed magnetic tape device. 
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The procedure responds with the following messages: 

VAX/VMS Software Product Installation Procedure 
It is 11-MAR-1985 at 12:00. 

Enter a question mark (?) at any time for help. 

3. The messages are followed by a series of questions. You must answer 
Y [YES], N [NO], or a question mark (?) for help. The bracketed 
response is the default. 

* Are you satisfied with the backup of your system disk [YES]? YES 
_MTA0: allocated 


Assu ming that you have performed the necessary backup, enter Y or 
press I RET I . If you reply with N, the installation procedure is aborted. 

4. Mount the first kit volume of the compiler. Type YES when ready. 
Please mount volume 1 of the set on MTAO: 

* Are you ready? YES 

•/.MOUNT-1-MOUNTED, PASCAL mounted on _MTA0: 

5. The procedure then continues with: 

The following products will be processed: 

PASCAL V3.0 

Beginning installation of PASCAL V3.0 at 12:05 

•/.VMSINSTAL-I-RESTORE, Restoring product saveset A. . . 

The procedure (1) checks whether there is adequate disk space to 
install the compiler, and (2) ensures that you are running Version 4 or 
later. If either test fails, the installation procedure issues an appropriate 
error message and terminates; otherwise it processes the files on the 
first volume. 

6. After the first volume is complete, the procedure prompts you to mount 
any remaining volumes. If there are additional volumes, you receive 
the following messages: 

•/.BACKUP-1-RESUME, resuming operation on volume 2 
•/.BACKUP-1-READYREAD, mount volume 2 on _MTA0: for reading 
Enter "YES” when ready: YES 
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When all volumes have been read, the procedure issues the following 
message: 


*-* 

* Installation Command Procedure for * 

* VAX PASCAL V3.0 * 

* -* 


7. The procedure then asks you if you want a printed copy of the edit 
history file. Type YES or NO in response. 

This kit contains a file summarizing the changes made to 

the VAX PASCAL compiler since its last release (VAXPASUPD.MEM). 

* Do you want this file printed [YES]? YES 

A copy of VAXPASUPD.MEM remains in SYS$UPDATE. 

8. You are then asked if you want to purge files. 

* Do you want to purge files replaced by this 
installation [YES]? YES 

If you type YES, all older versions of the compiler are deleted and 
replaced with new files; purging is recommended. If you type NO, the 
files will remain. The HELP library gets updated in either case. 

NOTE 

You may need to purge old versions of the compiler if 
you have a system that requires tailoring (such as the 
VAX-11/730 dual RL02 system), as you may not have 
sufficient space for the new compiler. 

9. The procedure asks if you want to execute the Installation Verification 
Procedure. 

This kit contains an Installation Verification Procedure 
to verify the correct installation of the VAX PASCAL compiler. 

* Do you want to run the IVP after the installation 
[YES]? YES 

10. The procedure then prints the following: 

All questions regarding the installation have now been 
asked. The installation of VAX PASCAL will now 
continue approximately 10-25 minutes. 
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Your VMS system will now be updated to include the 
following new and modified files: 


SYS$SYSTEM:PASCAL.EXE [new] 

SYS$LIBRARY:DCLTABLES.EXE [modified] 

SYS$HELP:HELPLIB.HLB [modified] 

SYS$LIBRARY:LIBDEF.PAS [new] 

SYS$LIBRARY:MTHDEF.PAS [new] 

SYS$LIBRARY:PASDEF.PAS [new] 

SYS$LIBRARY:PASSTATUS.PAS [new] 

SYS$LIBRARY:SIGDEF.PAS [new] 

SYS$MESSAGE:PASCALERl.PAS [new] 

SYS$MESSAGE:PASCALER2.PAS [new] 


Your VMS system may also be updated to include the 
following new and modified files: 


SYS$LIBRARY:PASRTL.EXE [new] 

SYS$LIBRARY:MTHRTL.EXE [new] 

SYS$LIBRARY:UVMTHRTL.EXE [new] 

SYS$MESSAGE:PASMSG.EXE [new] 

SYS$LIBRARY:STARLET.OLB [modified] 


•/oVMSINSTAL-I-MOVEFILES, files will now be moved to their 
target directories... 


11. If you chose to execute the Installation Verification Procedure, the 
following message is issued: 


♦ - * 

* Installation Verification Procedure for * 

* VAX PASCAL V3.0 * 

* -s|c 


The procedure compiles, links, and executes a test program. When the 
IVP has completed, you should receive the following message: 

** Successful Installation of VAX PASCAL V3.0 on ll-MAR-1985 at 12:10 ** 

12. When the installation has completed, you should receive the following 
messages: 

Installation of PASCAL V3.0 completed at 12:10 
VMSINSTAL procedure done at 12:10 
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13. If you wish to install the STARLET.PAS and STARLET.PEN library 
files, you should issue the following command: 

$ @SYS$UPDATE:VMSINSTAL PASSTR030 MTAO: 

14. The procedure responds with: 

Please mount the first volume of the set on MTAO:. 

Are you ready? YES 

•/.MOUNTED-1-MOUNTED, PASSTR mounted on ^MTAO: 

Type YES when you are ready to continue. 

15. The procedure then prints: 

The following products will be processed: 

PASSTR V3.0 


Beginning installation of PASSTR V3.0 at 12:20 
•/.VMSINSTAL-1-RESTORE, Restoring product saveset A...) 

16. After the first volume is complete, the procedure prompts you to mount 
any remaining volumes. If you mount additional volumes, you should 
receive the following messages: 

•/.BACKUP-1-RESUME, resuming operation on volume 2 
•/.BACKUP-1-READYREAD, mount volume 2 on _MTA0: for reading 
Enter "YES” when ready: YES 

When all volumes have been read, the procedure issues the following 
message: 


*-* 

* Installation Command Procedure for VAX PASCAL * 

* libraries STARLET.PAS and STARLET.PEN * 

5|C-)|C 


17. You are then asked if you want to purge files. 

* Do you want to purge files replaced by this 
installation [YES]? YES 

If you type YES, all older versions of the compiler are deleted and 

replaced with new files; purging is recommended. If you type NO, the > 

files will remain. 
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NOTE 


You may need to purge old versions of STARLET.PAS if 
you have a system that requires tailoring (such as the VAX- 
11/730 dual RL02 system), as you may not have sufficient 
space for the new STARLET. 

18. The procedure then prints the following message: 

All questions regarding the installation have now 
been asked. The installation of VAX PASCAL 
STARLET.PAS and STARLET.PEN will now continue 
for approximately 20-25 minutes. 

Your VMS system will now be updated to include the following 
new files: 

SYS$LIBRARY:STARLET.PAS 
SYS$LIBRARY:STARLET.PEN 

y,VMSINSTAL-I-MOVEFILES, Files will now be moved to their 
target directories... 

19. When the STARLET installation has completed, the procedure then 
issues the following message: 

Installation of PASSTR V3.0 completed at 12:46 
VMSINSTAL procedure done at 12:46 


1.4 Installing PASCAL and PASRTL as Known Shared Images 

If your PASCAL compiler is used frequently, you should specify the 
compiler as a known, shared image to the VAX/VMS system. 

In addition, if PASCAL programs are frequently executed, you should 
also specify PASRTL, the PASCAL-specific, shareable Run-Time Library 
image, as a known, shared image. This reduces both the time required 
for invocation, and the memory required when more than one user is 
compiling or running PASCAL programs. 

To specify PASCAL and PASRTL as known, shared images, use the 
VAX/VMS INSTALL utility described in the VAX/VMS System Management 
and Operations Guide, 
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NOTE 


You should be logged in to the system manager's account 
when performing the following operations. Also, you should 
perform these operations on a system that has just been boot¬ 
strapped. This ensures that the global page table has not 
become fragmented by previous deletions of installed shared 
images. Because contiguous space is required for known, shared 
images, fragmenting the available global page table space could 
cause the INSTALL utility to fail, even if sufficient total space is 
available. 


1.4.1 Preparation 

Before specifying PASCAL and PASRTL as known, shared images, 
you must ensure that the system SYSGEN parameters GBLPAGES and 
GBLSECTIONS are large enough to accommodate PASCAL and PASRTL. 
You do this by using the INSTALL and SYSGEN utilities as follows: 

1. Invoke the INSTALL utility by typing: 

$ RUN SYS$SYSTEM:INSTALL 

The INSTALL utility then responds with the INSTALL> prompt. 

2. To display the existing global sections already known to VAX/VMS, 
type: 

INSTALL>/GLOBAL 

Some of the information that the INSTALL utility lists is as follows: 

• All known global sections 

• The number of global sections used 

• The number of global pages used and unused 

The PASCAL compiler uses approximately 1100 global pages, and the 
PASRTL shareable image uses approximately 80 global pages, for a 
total of approximately 1180 global pages. If you don't have 1180 pages 
available, you can obtain more by deleting an existing known image, 
or by increasing the GBLPAGES system parameter with the SYSGEN 
utility. You may also decide to install only PASCAL if you think that 
your site will be primarily compiling, or only PASRTL if your site will 
be primarily executing PASCAL programs. 

Type /EXIT to exit the INSTALL utility. 
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3. Display the existing number of available global sections by typing: 

$ RUN SYS$SYSTEM:SYSGEN 
SYSGEN>USE CURRENT 
SYSGEN>SHOW GBLSECTIONS 

The procedure responds with the number of global sections. The 
current maximum number of global sections is the first number. 
PASCAL requires two global sections and PASRTL requires four 
global sections, for a total of six global sections. If you do not have 
enough global sections (compare the number shown by SYSGEN 
with the number currently used as shown by INSTALL), you can 
obtain more by deleting an existing global section or by increasing the 
GBLSECTIONS parameter with the SYSGEN utility. 

4. In addition, if you are installing the PASCAL compiler with privileges, 
then all shareable images used must also be installed. These share¬ 
able images include the callable interface to the VAX Common Data 
Dictionary, CDDSHR.EXE, and the two message files PASCALER1.EXE 
and PASCALER2.EXE. This is meant as a security feature in VAX/VMS 
to prevent a user from activating a private (non-installed) image with 
privileges. 

Likewise, if your system already has the callable interface to the 
VAX Common Data Dictionary, CDDSHR.EXE, installed as a pro¬ 
tected image, then the two message files PASCALER1.EXE and 
PASCALER2.EXE must be installed as well. 


1.4.2 Using INSTALL at System Bootstrap Time 

If you wish to have the system bootstrap procedure automatically specify 
PASCAL and PASRTL as known, shared images, modify the site-specific 
command procedure SYS$MANAGER:SYSTARTUP.COM as follows: 

1. Check that the INSTALL utility command is contained in the command 
file. If not, insert the following command: 

$ RUN SYS$SYSTEM:INSTALL 

2. Specify PASCAL and PASRTL in the list of image names following the 
INSTALL utility invocation. When a command is given or a program 
is run, VAX/VMS searches the list of known images in the opposite 
order in which they were installed. Therefore, PASCAL and PASRTL 
should be included after less frequently used images but before more 
frequently used images. 
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By default, VAX/VMS installs PASRTL as a known image only, not 
as a shared image. To install PASRTL as a known shared image, you 
must first tell INSTALL to delete its previous knowledge of PASRTL. 
To specify PASCAL and PASRTL in this list of image names, insert the 
commands: 

INSTALL>SYS$SYSTEM :PASCAL.EXE/OPEN/SHARED/HEADER_RESIDENT 
INSTALL>SYS$SHARE :PASRTL.EXE/DELETE 

INSTALL>SYS$SHARE :PASRTL.EXE/OPEN/SHARED/HEADER_RESIDENT 

3. PASCAL and PASRTL become known shared images to VAX/VMS the 
next time the system is bootstrapped. See Section 1.4.3 if you want 
PASCAL and PASRTL to be installed as shared images before a system 
reboot. 

You should note that, by default, VAX/VMS automatically installs 
SYS$MESSAGE:PASMSG.EXE, the PASCAL run-time message section, as 
a known image. You should not attempt to install PASMSG as a known 
shared image, as there is no advantage in doing so. 


1.4.3 Using the INSTALL Utility During Timesharing 

To specify PASCAL or PASRTL as a known shared image on the current 
system without rebooting the system, or to replace an old version of 
PASCAL or PASRTL with a new version, use the following procedure: 

1. Check that there are enough global pages and sections available (see 
Section 1.4.1). 

2. To determine whether an older version of PASCAL or PASRTL is a 
known image, type: 

$ RUN SYS$SYSTEM:INSTALL 
INSTALL>/LIST 

The system responds with a list of current known images. 

3. If you are installing PASCAL, and if PASCAL is already a known 
image, replace it with the following command: 

INSTALL> SYS$SYSTEM:PASCAL.EXE/REPLACE 

If PASCAL is not already a known image, specify the location of the 
PASCAL image by typing: 

INSTALL> SYS$SYSTEM:PASCAL.EXE/OPEN/SHARED/HEADER.RESIDENT 


1-10 installation Guide 





4. If you are installing PASRTL, it should already be a known image; 
however, it may now be installed as a shared image. 

If PASRTL is shown as being already installed as a shared image, 
replace it with the following command: 

INSTALL> SYS$SHARE:PASRTL.EXE/REPLACE 

If PASRTL is currently a known but not a shared image, install it with 
the following commands: 

INSTALL> SYS$SHARE:PASRTL.EXE/DELETE 

INSTALL> SYS$SHARE:PASRTL.EXE/OPEN/SHARED/HEADER^RESIDENT 


1.5 Update Releases 

DIGITAL may periodically issue update releases of VAX PASCAL. Each 
update will consist of new distribution media labeled similarly to the 
media in the original release. To update your system, use the procedure 
described in Section 1.3 and the cover letter accompanying the media. 

The following changes are made in each update release: 

• The version number is incremented. For example, if the original 
compiler had a version number of V3.0, and four changes were made 
in the compiler, the compiler's new version number would be V3.1-5. 

• A new version of the compiler executable image file, PASCAL.EXE, is 
supplied. 

• The VAXPASUPD.MEM file is updated to document all changes made 
to the compiler since the initial release of Version 3 of VAX PASCAL. 

• A new version of the PASCAL STARLET library files may be supplied. 

Note that when installing any VAX PASCAL update releases, you do not 
need to install previous versions. A VAX PASCAL update completely 
replaces any previous versions. 


I 
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1.6 Edit History File 


The VAX PASCAL Version 3 installation kit provides an edit history file 
called VAXPASUPD.MEM.^his file lists all the changes made to the 
compiler after the initial release. The following information is provided 
for each change: 

• The SPR number (if there is one) that prompted the change 

• A short description of the problem 

• A short description of the change 

The VAXPASUPD.MEM file is updated each time a VAX PASCAL kit is 
built. As part of the installation procedure, this file is copied from the 
kit volume to the directory [SYSUPD] on the target-system disk. At your 
request, the installation procedure prints the file from the target disk. The 
file is located in the directory [SYSUPD] on the target disk and can be 
printed as often as desired. 
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Chapter 2 

Compatibility Notes 


This chapter describes the compatibility between previous versions of VAX 
PASCAL and VAX PASCAL V3.0. The following topics are discussed: 

• Section 2.1 describes source, object and image compatibility between 
earlier versions of VAX PASCAL and the new version. 

• Section 2.2 describes command line changes. 

• Section 2.3 describes ways to improve performance. 

• Section 2.4 describes a possible failure when using the %DICTIONARY 
directive. 


2.1 Compatibility 


2.1.1 Source Compatibility 

The source language accepted by the VAX PASCAL V3.0 compiler is 
upwardly compatible with that accepted by the V2.0 compiler. 


2.1.2 Object Compatibility 

The object files produced by the VAX PASCAL V3.0 compiler are up¬ 
wardly compatible with the V2.0 object files. They can be mixed freely in 
the same executable image. 
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2.1.3 Compatibility of Images 

The images linked with VAX PASCAL V3.0 object modules are strictly 
compatible with similar images using V2.0 modules. 

Images linked on VAX/VMS V4.0 systems are not downwardly compatible 
and will not run on VAX/VMS V3.0 systems. 

Images linked on VAX/VMS V4.0 or V4.1 systems (against the new 
PASRTL and MTHRTL) are not downwardly compatible with systems 
running older versions of VAX PASCAL. If you link a program on a 
VAX/VMS V4.0 or V4.1 system that has VAX PASCAL V3.0 installed, 
that program will not run on another VAX/VMS V4.0 or V4.1 system 
unless VAX PASCAL V3.0 has been installed. A VAX PASCAL program 
linked on a system with VAX PASCAL V3.0 must be executed only on 
systems with either VAX PASCAL V3.0 installed or VAX/VMS V4.2 (or 
later) installed. 


2.1.4 Environment Files 

The environment files produced by a VAX PASCAL V2.0 compiler will be 
accepted by the VAX PASCAL V3.0 compiler, but a warning message will 
be issued. We recommend that all environment modules be recompiled 
with the VAX PASCAL V3.0 compiler. 

Environment files produced by the VAX PASCAL V3.0 compiler will not 
be accepted by a V2.0 compiler. 


2.1.5 Symbol Definition Fiies 

The symbol definition files provided with the VAX PASCAL V3.0 com¬ 
piler are identical with those provided with the V2.0 compiler, with the 
following exceptions: 

• PASDEF.PAS - 

Addition of new symbol definitions 
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• PASSTATUS.PAS - 


Addition of new symbol definitions 
Removal of the CONST reserved word 


2.1.6 Behavior Differences 

There are several differences in behavior that you will notice when 

migrating from a VAX PASCAL V2.0 compiler to VAX PASCAL V3.0: 

• Debugging Behavior—If you use the debugger to debug programs that 
were compiled with /OPTIMIZE, you may notice that debugging has 
become more difficult. In particular, an optimization has been added 
that causes the calls to some routines to "disappear" due to inline 
expansion of user-defined routines. For this reason, we recommend 
that you specify the /NOOPTIMIZE qualifier whenever using the 
/DEBUG qualifier. 

• String Padding Behavior—Previously, when /NOCHECK was spec¬ 
ified, the compiler generated code that null-padded some string 
assignment and comparison operations. Though this behavior was 
never documented, it is possible that existing programs depend on 
this behavior. Since the compiler now performs blank-padding of the 
shorter string before the assignment or comparison is performed, these 
programs may now behave differently. 


2.1.7 STARLET.PAS 

Both VAX PASCAL STARLET V2.6 and VAX PASCAL STARLET V3.0 de¬ 
scribe VAX/VMS V4 systems. VAX PASCAL STARLET V3.0 is upwardly 
compatible with VAX PASCAL STARLET V2.6. 

If you are upgrading from VAX PASCAL STARLET V2.0 to VAX 
PASCAL STARLET V3.0, source program changes may be required. 

Since STARLET V2.0 describes VAX/VMS V3 systems and STARLET 
V3.0 describes V4 systems, any system data structures or entry points that 
changed in VMS will also be reflected in STARLET.PAS. The most impor¬ 
tant of these is the use of UNSIGNED for many parameters in STARLET 
V3.0 that used to be declared INTEGER in STARLET V2.0. 
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2.2 Output File Specifications on Command Lines 


The compiler's behavior in determining the directory used for the output 
object, listing, and environment files has been changed to agree with the 
documentation and other DCL commands. Both the old and new behavior 
are described below, as well as the recommended changes to command 
files that depend on the old, incorrect behavior. 

In the examples below, assume that the default device and directory 
specification is set to: 

MYDEV:[MYDIR] 


2.2.1 Behavior of VAX PASCAL V2.0 

In VAX PASCAL V2.0, and all prior versions, the command 
$ PASCAL [XYZlMYFILE/OBJECT 

produced an object file in directory [MYDIR], the default, rather than 
in directory [XYZ], which contained the input file. This was contrary to 
the documentation for the specification of output files in the VAX/VMS 
Command Language User's Guide, and inconsistent with other system lan¬ 
guage processors. The same was true of the /LIST and /ENVIRONMENT 
qualifiers. 

Note that this applies only to the use of the /LIST, /OBJECT, and 
/ENVIRONMENT qualifiers used following an input file specification. 
When these qualifiers are used following the PASCAL command, the use 
of the default directory for the output file is correct and has not changed. 

In addition, when a file specification is given explicitly with the qualifier, 
the normal defaulting rules apply, including use of the default device and 
directory, even if they are different from the device and directory of the 
input file. For example, if the command 

$ PASCAL [XYZ]MYFILE/OBJECT=[] 

were given, the object file would be placed in the default directory as 
given in the object file specification. This behavior is also correct and has 
not changed. 
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2.2.2 Behavior of VAX PASCAL V3.0 

In PASCAL V3.0, the command 
$ PASCAL [XYZ]MYFILE/OBJECT 

produces an object file in directory [XYZ], the same as the input file 
specification. This behavior corresponds with the documentation for 
the behavior of the qualifiers and with the behavior of other system 
language processors. The behavior when the /LIST, /OBJECT, and 
/ENVIRONMENT qualifiers are used after the PASCAL command, and 
when an explicit file specification is given with the qualifier, is correct and 
has not changed. 


2.2.3 How to Change Command Files 

If you have command files which use the form of the PASCAL command 
described above, you will need to modify them to accommodate this 
change. To do this, supply the default file specification explicitly with the 
output qualifier. Thus, to modify the command 

$ PASCAL [MYDIR.PASCAL.SOURCE]PROGl.PAS/OBJECT/LIST 

so that the output files are placed in the default directory [MYDIR], you 
need to add explicit default file specifications to the qualifiers. For example 

$ PASCAL [MYDIR.PASCAL.SOURCE]PROGl.PAS/OBJECT=[]/LIST=[] 

will work as the previous command with both VAX PASCAL V2.0 and 
V3.0. 


2.3 Improving Performance 

If your system makes heavy use of VAX PASCAL Version 3, you may 
want to install the software using the VMS INSTALL utility, which may 
improve performance. You should install SYS$SYSTEM:PASCAL.EXE as 
open, shared, and header-resident. You should also install SYS$LIBRARY: 

PASRTL.EXE with the same characteristics. More information about 
how to install these images is provided in Chapter 1 of this manual. The 
INSTALL utility is described in full in the VAX/VMS Utilities Reference 
Manual. 
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2.4 Possible Failure of the %DICTIONARY Directive 


Should the compilation of a routine containing a %DICTIONARY directive 
fail with multiple errors of the form 

y.LIB-E-ACTIMAG£, error activating image sy8$library:CDDSHR.EXE:5 
-SYSTEM-F-PROINSTALL, protected images must be installed 

and the routine prematurely terminate with an access violation, the 
problem may be due to an unsuccessful installation of the VAX Common 
Data Dictionary. It may be necessary to rerun the product installation 
procedure for the VAX Common Data Dictionary. You must also ensure 
that the CDDSHR.EXE shareable image is made a known image via the 
VMS INSTALL utility. You can make CDDSHR.EXE a known image with 
the following INSTALL command: 

INSTALL> SYS$SHARE:CDDSHR/OPEN/HEAD/SHARE/PROT 
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